home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / appicon tools / etrashcan / etrashcan_v1.1.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  9KB  |  180 lines
  1. @database 002e6048-0
  2. @master ETrashCan_V1.1.guide
  3. @$VER: 1.1
  4. @author "Andrew Cook"
  5. @(c) "Andrew Cook"
  6. @remark Created with Heddley v1.1 (c) Edd Dumbill 1994
  7. @node "Main" "Welcome to ETrashCan"
  8.                       @{b}ETrashCan Version 1.1@{ub} (10.12.95)
  9.                                @{"Introduction" link "Introduction" 0}
  10.                                  @{"Features" link "Features" 0}
  11.                           @{"What
  12. it" link "Requirements" 0}
  13.                            @{"How
  14. ETrashCan" link "Usage" 0}
  15.                         @{"How
  16. configure
  17. ETrashCan" link "config" 0}
  18.                     @{"About
  19. Author/Development
  20. system" link "Author" 0}
  21.                              @{"Icky
  22. Legal
  23. Stuff" link "Legal" 0}
  24.                                  @{"History" link "history" 0}
  25. @endnode
  26. @node "Introduction" "Introduction to ETrashCan"
  27. @{b}Introduction@{ub}
  28. I used to use a program called @{"TrashIcon" link "TrashIcon" 0}. It put up a little picture of a
  29. trashcan on the workbench, and deleted files you dragged over it. It would
  30. override file protections if you wanted it to, and recursively delete
  31. directories. Very nice it was too. It's big drawback was that it instantly
  32. deleted what you dragged over it, no second chances. One day I managed to
  33. delete a rather large file that I'd just downloaded. After that I stopped
  34. running TrashIcon
  35. I browsed through similar programs on Aminet, but they all seemed to do the
  36. same thing. Instant delete and no way to recover the file.
  37. I'd just registered the @{"E
  38. compiler" link "E_compiler" 0}, so I decided to get back into Amiga OS
  39. programming and learn E at the same time, by writing a trashcan program that
  40. worked how I wanted it to.
  41. My initial thought was to move all the files dropped on the trashcan into a
  42. directory, the contents of which could then be deleted later. The problem was
  43. where to put this directory. With the directory on any given volume a file may
  44. not fit in, and on a floppy based system the volume may not be available when
  45. needed.
  46. So I decided to use the :trashcan directory on the same volume as the file to
  47. be deleted. Once an icon is dropped onto the trashcan the disk that icon is on
  48. is checked for a directory in it's root called 'trashcan'. If it doesn't exist
  49. it is created. The file and it's icon are then moved into it.
  50. When a uses chooses to empty the trash, all files in ':trashcan' directories
  51. on all the mounted volumes are recursively deleted. At this point protection
  52. bits are ignored.
  53. @endnode
  54. @node "Features" "Features of ETrashCan"
  55.  Why should you use this program rather than one of the myriad of other
  56. trashcan programs floating around ?
  57.     @{b}o@{ub}   Easy File Recovery - just drag the files out of the trashcan
  58.     @{b}o@{ub}   Icon image shows if there are any files in the trashcan
  59.     @{b}o@{ub}   It's free. Just send @{"me" link "Author" 0} some mail. Not shareware like some.
  60.     @{b}o@{ub}   @{"Set
  61. icontext" link "config" 0}
  62.     @{b}o@{ub}   @{"Set
  63. position
  64. icon" link "config" 0} on Workbench
  65. @endnode
  66. @node "Requirements" "Requirements"
  67. @{b}What do you need to run ETrashCan ?@{ub}
  68.     @{b}o@{ub}   An Amiga :-)
  69.     @{b}o@{ub}   Workbench 3.0 or above.
  70.     @{b}o@{ub}   It works best with hard drives (doesn't everything)
  71. @endnode
  72. @node "Usage" "How to use ETrashCan"
  73. @{b}ETrashCan may only be run from WorkBench@{ub}. If run from the CLI it will put up a
  74. requester saying so, then quit.
  75. To run it whenever you reboot your Amiga put in in the WBStartup drawer.
  76. When started an appicon will appear on the Workbench screen. It will attempt
  77. to use the icons specified in the @{b}TRASHCAN_FULL@{ub} and @{b}TRASHCAN_EMPTY@{ub} @{"tooltypes" link "config" 0}
  78. for it's imagery. Failing that it will default to the image stored in
  79. '@{b}env:sys/def_trashcan@{ub}' for both full and empty states.
  80. If you have a file or directory to delete drag it over the trashcan. It will
  81. be moved into the ':trashcan' directory that is on the same device. If that
  82. directory doesn't exist it will be created. If you decide you didn't want to
  83. get rid of it after all, just open up the trashcan directory and drag the file
  84. out again, back to where you want it.
  85. To actually delete all the files you have dragged into the trashcan, double
  86. click on the trashcan icon and choose 'Empty Trash' from the requester. The
  87. program will scan all mounted volumes for ':trashcan' directories and delete
  88. all files in those directories. It will delete files regardless of protection
  89. bits.
  90. @endnode
  91. @node "config" "Configuration"
  92. Currently ETrashCan is configured via it's tooltypes. I may add a preference
  93. editor at a later date
  94. Current tooltypes are:
  95.  @{b}XPOS@{ub}               The x position of the appicon on the Workbench Screen
  96.  @{b}YPOS@{ub}               The y position of the appicon on the WorkBench Screen
  97. If these are not set, or the values are such that the icon  wouldn't fit on
  98. the screen, it will be placed in a default position
  99.  @{b}ICONNAME@{ub}           The text to appear under the appicon
  100. If this is not set, the default 'ETrashCan' will be used.
  101.  @{b}TRASHCAN_FULL@{ub}      The path to the icon to use to represent the full
  102.                     trashcan
  103.  @{b}TRASHCAN_EMPTY@{ub}     The icon that shows the empty trashcan
  104. Give the filename for the icons, without the .info extension, eg mine are in
  105. MagicWB:Trashcan_empty and MagicWB:Trashcan_full. The supplied tooltypes
  106. expect to find these icons (samples included in the archive) in the same
  107. directory as the program. If either these tooltypes are missing or the
  108. specified icon files can't be found, the default trashcan will be used.
  109.  @{b}DONOTWAIT@{ub}         A standard tooltype for running from the WBstartup
  110.                     drawer. ETrashCan itself ignores it.
  111. @endnode
  112. @node "Author" "About the Author"
  113. ETrashCan version 1.1 was written by:
  114.     Andrew Cook
  115.     147 Blackshaw Road
  116.     London, SW17 0BU
  117.     England
  118.     Email: sgms107@sghms.ac.uk (preferred)
  119.            rhialto@falu.demon.co.uk
  120.            rhialto@tao.btc.uwe.ac.uk
  121.     URL:   http://tao.btc.uwe.ac.uk/~rhialto
  122. It was developed on a 68030 based Amiga 1200 with 2MB chip and 4MB fast RAM,
  123. 200MB hard drive with OS 3.0
  124. It was written using @{"Amiga
  125. E" link "E_compiler" 0} v3.2e.
  126. If you like and use ETrashCan please let me know. EMail would be fine, though
  127. would prefer a nice scenic postcard of where you live.
  128. @endnode
  129. @node "TrashIcon" "TrashIcon"
  130. TrashIcon V2.3, by Mark McPhereson
  131. Available on Aminet
  132. @endnode
  133. @node "E_compiler" "Amiga E"
  134. Amiga E was written by Wouter van Oortmerssen, he describes it as follows.
  135. @{b}From E.guide@{ub}:
  136. E is an object oriented / procedural / unpure functional higher programming
  137. language, mainly influenced by languages such as C++, Ada, Lisp etc.  It is a
  138. general-purpose programming language, and the Amiga implementation is
  139. specifically targeted at programming system applications.  The number of
  140. features of the language is really too great to sum up entirely, and include:
  141. speed of >20000 lines/minute on a 7 Mhz amiga, inline assembler and linker
  142. integrated into compiler, large set of integrated functions, great module
  143. concept with v39 includes as modules, flexible type-system, quoted
  144. expressions, immediate and typed lists, parametric and inclusion polymorphism,
  145. exception handling, inheritance, data-hiding, methods, multiple return values,
  146. default arguments, register allocation, fast memory management, unification,
  147. LISP-Cells, gui-toolkit, (macro-) preprocessor, very intuitive and powerful
  148. source-level debugger, easy .library linking, and much more...
  149. This is what 'HelloWorld' looks like in E:
  150. /* nominated for Most Boring Example */
  151.  PROC main()
  152.    WriteF('Hello, World!\n')
  153.  ENDPROC
  154. @endnode
  155. @node "Legal" "Copyright and Distribution"
  156. ETrashCan is Copyright 
  157. 1995 by @{"Andrew
  158. Cook" link "Author" 0}
  159. This program is MailWare. If you like it and use it regularly, then please
  160. send @{"me" link "Author" 0} a nice scenic postcard of the town/city/country where you live. If
  161. that's too much fuss, then just send me some email and let me know you're
  162. using the program.
  163. As is traditional, this program has absolutely no warranty. If you lose
  164. important files or your computer blows up because you're using ETrashCan then
  165. hard luck. I can in no way be held responsible.
  166. On the other hand, I'm eager to hear about any bugs/problems you may have with
  167. the program so I can fix them.
  168. This program archive may be freely distributed on floppy disks on a non-profit
  169. making basis. It may be included on Aminet and Fred Fish CD-ROMS. If you want
  170. to put it on any other CD-ROMS or Magazine coverdisks please contact me first.
  171. @endnode
  172. @node "history" "The History of ETrashCan"
  173. @{b}Version 1.0 (29.11.95)@{ub}
  174.     First (locally) distributed version.
  175. @{b}Version 1.1 (29.11.95)@{ub}
  176.     Added support for seperate icon images for full and empty
  177.     trashcans.
  178.     First Aminet release.
  179. @endnode
  180.